home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / ronset21.zip / RONSET.DOC < prev    next >
Text File  |  1990-03-04  |  33KB  |  841 lines

  1.  
  2.                             RONSET
  3.                             ------
  4.  
  5.                         Batch file enhancer
  6.                         Copyright (C) Ron Bemis 1990
  7.                         All rights reserved
  8.                         Version 2.1
  9.                           
  10.  
  11. I use DOS environment variables extensively, and I wanted a better way to
  12. set and use them.  I couldn't find it, so I wrote it myself.  Here it is -
  13. my idea of the ultimate batch file utility.  It lets you set environment
  14. variables to whatever you like... with brains.  It does what DOS should
  15. have done.  This program is the equivalent of the internal DOS SET command,
  16. but it's much more powerful.  You can use it just like you use SET.
  17.  
  18. I hope you'll enjoy this program, and I also hope that you'll consider
  19. sending in a registration if you like it.  Please let me know if you find
  20. something that doesn't work like you think it should.  Also, please let me
  21. know if you think of any enhancements for this program.
  22.  
  23.                  - Ron Bemis, FidoNet 124/1113, 214-213-3841
  24.  
  25. RONSET is shareware!  That means that if you use it on a regular basis, you
  26. must pay for it.  You are hereby granted a limited licence to use this
  27. program for a period of one month.  At the end of this month, you must
  28. either register this program or discontinue its use.  This program may NOT
  29. be used in a business, for-profit organization, or corporate environment
  30. without first being registered.  Registration price for this program is $20
  31. per machine.  Registrations should be mailed to:
  32.  
  33.                Ron Bemis
  34.                9601 Forest Ln #222
  35.                Dallas, TX  75243
  36.  
  37.  
  38. Happy batchin'!
  39.  
  40.  
  41. By the time you're done playing with this program, you should understand
  42. what the following line does and how it works:
  43.  
  44. RONSET fname=low(concat(hex(string(Net:,5)),hex(string(Node:,5))).REQ)
  45.  
  46. At least try each function by itself on the command line to see how they
  47. work.  Satisfy yourself that each function does work as you think it
  48. should.  I think there's about a zillion things you can do with this
  49. program if you cut loose with the creative juices.
  50.  
  51. The above illustrates how you can "nest" RONSET commands to execute a number
  52. of them at the same time and with respect to the same environment variable. 
  53. But we're gettin' ahead of ourselves, here. 
  54.  
  55.  
  56.         COMMAND SYNTAX:
  57.  
  58. RONSET variable_name=function(parameters)
  59.  
  60.         In which:
  61.  
  62. variable_name   is replaced by the name of the environment variable you
  63.                 want to create or replace;
  64.  
  65. function        is any one of the many functions listed in this
  66.                 documentation;
  67.  
  68. (parameters)    are additional commands you give to RONSET.  These commands
  69.                 are dependent upon the function you have asked for.
  70.  
  71. All function parameters MUST be enclosed entirely within parenthesis as
  72. shown above. In this documentaiton, the word "parameter" refers to whatever
  73. it is you're enclosing within the parenthesis.
  74.  
  75.  
  76. Arithmetic functions
  77. --------------------
  78. All arithmetic is done with floating point numbers.
  79.  
  80. add(addend,addend)
  81.     returns the sum of the two values
  82.         Example:                            Result:
  83.         RonSet Sum=add(15,32)               SUM=47
  84.  
  85. sub(minuend,subtrahend)
  86.     returns the difference of the two values
  87.         Example:                            Result:
  88.         RonSet Diff=sub(19,25)              DIFF=-6
  89.  
  90. mult(multiplicand,multiplier)
  91.     returns the product of the two values
  92.         Example:                            Result:
  93.         RonSet Prod=mult(15,32)             PROD=480
  94.  
  95. div(dividend,divisor)
  96.     returns the quotient of the two values
  97.         Example:                            Result:
  98.         RonSet Quot=div(100,7)              QUOT=14.2857
  99.  
  100. eq(x,y)
  101.     returns 1 if x is equal to y, 0 otherwise
  102.         Example:                            Result:
  103.         RonSet X=eq(5,6)                    X=0
  104.         RonSet X=eq(5,5)                    X=1
  105.  
  106. ne(x,y)
  107.     returns 1 if x is not equal to y, 0 otherwise
  108.         Example:                            Result:
  109.         RonSet X=ne(5,6)                    X=1
  110.         RonSet X=ne(5,5)                    X=0
  111.  
  112. lt(x,y)
  113.     returns 1 if x is less than y, 0 otherwise
  114.         Example:                            Result:
  115.         RonSet X=lt(5,6)                    X=1
  116.         RonSet X=lt(5,5)                    X=0
  117.         RonSet X=lt(6,5)                    X=0
  118.  
  119. le(x,y)
  120.     returns 1 if x is less than or equal to y, 0 otherwise
  121.         Example:                            Result:
  122.         RonSet X=le(5,6)                    X=1
  123.         RonSet X=le(5,5)                    X=1
  124.         RonSet X=le(6,5)                    X=0
  125.  
  126. gt(x,y)
  127.     returns 1 if x is greater than y, 0 otherwise
  128.         Example:                            Result:
  129.         RonSet X=gt(5,6)                    X=0
  130.         RonSet X=gt(5,5)                    X=0
  131.         RonSet X=gt(6,5)                    X=1
  132.  
  133. ge(x,y)
  134.     returns 1 if x is greater than or equal to y, 0 otherwise
  135.         Example:                            Result:
  136.         RonSet X=ge(5,6)                    X=0
  137.         RonSet X=ge(5,5)                    X=1
  138.         RonSet X=ge(6,5)                    X=1
  139.  
  140. abs(x)
  141.     returns the absolute value of x
  142.         Example:                            Result:
  143.         RonSet X=abs(-5)                    X=5
  144.         RonSet X=abs(10)                    X=10
  145.         RonSet X=abs(-2.3)                  X=2.3
  146.  
  147. mod(x,y)
  148.     returns x modulo y
  149.         Example:                            Result:
  150.         RonSet Rmn=mod(15,4)                RMN=3
  151.         RonSet Rmn=mod(20,4)                RMN=0
  152.         RonSet Rmn=mod(17,13)               RMN=4
  153.  
  154. neg(x)
  155.     returns negative x
  156.         Example:                            Result:
  157.         RonSet Neg=neg(15)                  NEG=-15
  158.         RonSet Neg=neg(-7.3)                NEG=7.3
  159.  
  160. sqr(x)
  161.     returns x squared
  162.         Example:                            Result:
  163.         RonSet Big=sqr(83)                  BIG=6889
  164.         RonSet Big=sqr(-100)                BIG=10000
  165.         RonSet Big=sqr(23.5)                BIG=552.25
  166.  
  167. sqrt(x)
  168.     returns the square root of x
  169.         Example:                            Result:
  170.         RonSet Root=sqrt(9)                 ROOT=3
  171.         RonSet Root=sqrt(8.7)               ROOT=2.94958
  172.  
  173. pow(x,y)
  174.     returns x to the y power
  175.     this one is an exception to the rules about errorlevels
  176.     if invalid values are specified, a different type of error message (one
  177.     from the floating point run-time library) is displayed, and the program
  178.     may abort with an errorlevel other than 255.
  179.         Example:                            Result:
  180.         RonSet OneK=pow(2,10)               ONEK=1024
  181.         RonSet Big=pow(7,5)                 BIG=16807
  182.  
  183.  
  184. Binary functions
  185. ----------------
  186. All binary functions are done with 16-bit unsigned numbers.
  187.  
  188. and(x,y)
  189.     returns the bitwise AND of x and y
  190.         Example:                            Result:
  191.         RonSet X=and(14,7)                  X=6
  192.  
  193. or(x,y)
  194.     returns the bitwise OR of x and y
  195.         Example:                            Result:
  196.         RonSet X=or(14,7)                   X=15
  197.  
  198. xor(x,y)
  199.     returns the bitwise XOR of x and y
  200.         Example:                            Result:
  201.         RonSet X=xor(14,7)                  X=9
  202.  
  203. not(x)
  204.     returns the 1's complement of x
  205.         Example:                            Result:
  206.         RonSet X=not(14)                    X=65521
  207.  
  208. hex(x)
  209.     returns the 4-digit hexidecimal equivalent of x
  210.         Example:                            Result:
  211.         RonSet X=hex(124)                   X=007C
  212.         RonSet X=hex(1113)                  X=0459
  213.  
  214. oct(x)
  215.     returns the 6-digit octal equivalent of x
  216.         Example:                            Result:
  217.         RonSet O=oct(29127)                 O=070707
  218.         RonSet O=oct(4096)                  O=010000
  219.  
  220. bin(x)
  221.     returns the 16-digit binary equivalent of x
  222.         Example: